kanzi::GridListBox2D Class Reference

Represents a node that layouts its list of 2D items in a grid. More...

#include <kanzi/ui/node/grid_list_box2d.hpp>

Inheritance diagram for kanzi::GridListBox2D:
kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits > kanzi::GridListBoxConcept kanzi::Node2D kanzi::ListBoxConcept kanzi::Node kanzi::ContentItemCollectionModel kanzi::Object kanzi::MetaObject kanzi::PropertyObject

Public Member Functions

GridDirection getDirection () const
 Gets the value of DirectionProperty. More...
 
void setDirection (GridDirection value)
 Sets the value of DirectionProperty. More...
 
float getCellWidth () const
 Gets the value of CellWidthProperty. More...
 
void setCellWidth (float value)
 Sets the value of CellWidthProperty. More...
 
float getCellHeight () const
 Gets the value of CellHeightProperty. More...
 
void setCellHeight (float value)
 Sets the value of CellHeightProperty. More...
 
float getItemAreaBegin () const
 Gets the value of ItemAreaBeginProperty. More...
 
void setItemAreaBegin (float value)
 Sets the value of ItemAreaBeginProperty. More...
 
float getItemAreaEnd () const
 Gets the value of ItemAreaEndProperty. More...
 
void setItemAreaEnd (float value)
 Sets the value of ItemAreaEndProperty. More...
 
Vector2 getScrollPosition () const
 Gets the value of ScrollPositionProperty. More...
 
Vector2 getScrollTargetPosition () const
 Gets the value of ScrollTargetPositionProperty. More...
 
Vector2 getScrollSpeed () const
 Gets the value of ScrollSpeedProperty. More...
 
bool isScrolling () const
 Gets the value of ScrollingProperty. More...
 
- Public Member Functions inherited from kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >
virtual bool addContentItem (NodeSharedPtr abstractItem) KZ_OVERRIDE
 
virtual bool removeContentItem (NodeSharedPtr abstractItem) KZ_OVERRIDE
 
virtual void removeAllContentItems () KZ_OVERRIDE
 
virtual size_t getContentItemCount () KZ_OVERRIDE
 
virtual NodeSharedPtr getContentItem (size_t index) KZ_OVERRIDE
 
PresenterSharedPtr getPresenter () const
 
size_t getItemCount ()
 Returns the total item count of the list box. Includes all virtual items. More...
 
optional< pair< size_t, size_t > > getAliveRange ()
 Returns the range of items being alive in the buffer (based on the KeepItemsAlive property). More...
 
bool isEmpty ()
 Returns true if the list box has no items. More...
 
LayoutVectorType getItemSize (size_t index)
 Returns size of the item at the given index or unbounded layout value if size could not be determined without acquiring the item first. More...
 
optional< size_t > getItemIndex (ItemSharedPtr item)
 Returns index of the given item. If the item does not exist currently, returns empty. More...
 
ItemSharedPtr getItem (size_t index)
 Gets the item at the given index in a list box. More...
 
void insertItem (size_t index, ItemSharedPtr item)
 Inserts an item at the given index in a list box when using the default object generator. More...
 
void removeItem (size_t index)
 Removes the item at the given index from a list box when using the default object generator. More...
 
void replaceItem (size_t index, ItemSharedPtr item)
 Replaces the item at the given index from a list box when using the default object generator. More...
 
void addItem (ItemSharedPtr item)
 Adds an item at the end of a list box when using the default object generator. More...
 
void removeLastItem ()
 Removes the last item from a list box when using the default object generator. More...
 
void removeAllItems ()
 Removes all items from a list box when using the default object generator. More...
 
void selectItem (optional< size_t > itemIndex)
 Requests the list box to select the item in the given index. More...
 
virtual void notifyItemAdded (size_t index) KZ_OVERRIDE
 Virtual functions for notifying item changes to list. More...
 
virtual void notifyItemRemoved (size_t index) KZ_OVERRIDE
 
virtual void notifyItemReplaced (size_t index) KZ_OVERRIDE
 
virtual void notifyItemCountChanged () KZ_OVERRIDE
 
void notifyItemContainerChanged ()
 
virtual LayoutVectorType measureOverride (LayoutVectorType availableSize) KZ_OVERRIDE
 
virtual void arrangeOverride (LayoutVectorType actualSize) KZ_OVERRIDE
 
void updateVisibleRangeQuiet (size_t beginIndex, size_t itemCount)
 Requests items from the item generator. More...
 
void updateVisibleRange (size_t beginIndex, size_t itemCount)
 Requests items from the item generator. More...
 
void updateVisibleRange (size_t beginIndex, size_t itemCount, bool sendMessages)
 
ScrollViewSharedPtr getScrollView () const
 Returns scroll view used for scrolling list box. More...
 
void bringItemCenter (size_t itemIndex, bool smooth)
 Requests the list box to focus on the item in the given index. More...
 
int getKeepAliveItemCount () const
 Gets the value of #KeepAliveItemCount. More...
 
void setKeepAliveItemCount (int value)
 Sets the value of #KeepAliveItemCount. More...
 
int getSelectedItemIndex () const
 Gets the value of #SelectedItemIndex. More...
 
void setSelectedItemIndex (int value)
 Sets the value of #SelectedItemIndex. More...
 
SelectionBehavior getSelectionBehavior () const
 Gets the value of SelectionBehavior. More...
 
void setSelectionBehavior (SelectionBehavior value)
 Sets the value of SelectionBehavior. More...
 
string getItemGeneratorTypeName () const
 Gets the value of #ObjectGeneratorTypeName. More...
 
void setItemGeneratorTypeName (string_view value)
 Sets the value of #ObjectGeneratorTypeName. More...
 
string getItemContainerGeneratorTypeName () const
 Gets the value of #ItemContainerGeneratorTypeName. More...
 
void setItemContainerGeneratorTypeName (string_view value)
 Sets the value of #ItemContainerGeneratorTypeName. More...
 
PrefabTemplateSharedPtr getItemTemplate () const
 Gets the value of #ItemTemplate. More...
 
void setItemTemplate (PrefabTemplateSharedPtr value)
 Sets the value of #ItemTemplate. More...
 
PrefabTemplateSharedPtr getItemContainerTemplate () const
 Gets the value of #ItemContainerTemplate. More...
 
void setItemContainerTemplate (PrefabTemplateSharedPtr value)
 Sets the value of #ItemContainerTemplate. More...
 
void setItemGenerator (ItemGeneratorSharedPtr itemGenerator)
 Sets the list box item generator. More...
 
void setItemContainerGenerator (ItemContainerGeneratorSharedPtr itemContainerGenerator)
 Sets the list box item container generator. More...
 
- Public Member Functions inherited from kanzi::Node2D
virtual ~Node2D ()
 
ChildConstIterator beginChildren () const
 
ChildConstIterator endChildren () const
 
ChildConstReverseIterator rbeginChildren () const
 
ChildConstReverseIterator rendChildren () const
 
void addChild (Node2DSharedPtr child)
 Adds a child node. More...
 
void insertChild (size_t index, Node2DSharedPtr child)
 Adds a child node for object node to given index. More...
 
void removeChild (const Node &child)
 Removes child node. More...
 
void removeChild (size_t index)
 Removes child node at specified index. More...
 
void removeAllChildren ()
 Removes all child nodes. More...
 
Node2DSharedPtr getChild (size_t index) const
 Returns a child from given index from object node. More...
 
size_t getChildIndex (const Node &child) const
 Returns the index of a child in an object node. More...
 
bool hasChild (const Node &child) const
 Returns whether or not the child exists. More...
 
size_t getChildCount () const
 Gets the number of children of the node. More...
 
void moveToBack ()
 Repositions the node to the beginning of its parent's children, so that it is drawn first. More...
 
void moveToFront ()
 Repositions the node to the end of its parent's children, so that it is drawn last. More...
 
RenderType getRenderType () const
 Get render type. More...
 
BrushSharedPtr getBackgroundBrush () const
 Gets value of BackgroundBrushProperty. More...
 
void setBackgroundBrush (BrushSharedPtr value)
 Sets value of BackgroundBrushProperty. More...
 
BrushSharedPtr getCompositionBrush () const
 Gets value of CompositionBrushProperty. More...
 
void setCompositionBrush (BrushSharedPtr value)
 Sets value of CompositionBrushProperty. More...
 
BrushSharedPtr getForegroundBrush () const
 Gets value of ForegroundBrushProperty. More...
 
void setForegroundBrush (BrushSharedPtr value)
 Sets value of ForegroundBrushProperty. More...
 
BrushRenderergetBackgroundBrushRenderer () const
 Get background brush renderer. More...
 
BrushRenderergetForegroundBrushRenderer () const
 Get foreground brush renderer. More...
 
BrushRenderergetCacheChildrenBrushRenderer () const
 Access cache children brush renderer. More...
 
BrushRenderergetCacheSelfBrushRenderer () const
 Access cache self brush renderer. More...
 
BrushRenderergetCompositionBrushRenderer () const
 Access cache result brush renderer. More...
 
SRTValue2D getRenderTransformation () const
 Gets the value of RenderTransformationProperty. More...
 
void setRenderTransformation (SRTValue2D value)
 Sets the value of RenderTransformationProperty. More...
 
SRTValue3D getPerspectiveTransformation () const
 Gets the value of PerspectiveTransformationProperty. More...
 
void setPerspectiveTransformation (SRTValue3D value)
 Sets the value of PerspectiveTransformationProperty. More...
 
void render (Renderer3D &renderer, CompositionStack &compositionStack)
 Render individual 2D node. More...
 
NodeVisual2DgetVisual () const
 Access visual component. More...
 
TextureSharedPtr getRenderTarget () const
 Gets value of RenderTargetProperty. More...
 
void setRenderTarget (TextureSharedPtr texture)
 Sets value of RenderTargetProperty. More...
 
TextureSharedPtr getFinalCompositionTarget () const
 Returns composition target combining all Node2D content. More...
 
bool hasCacheChildren () const
 Tell if node should cache its children. More...
 
bool hasCacheChildrenCompositionTarget () const
 Tell if node has cache children composition target. More...
 
bool isCacheChildrenValid () const
 Tell if children cache is valid. More...
 
void resetCacheChildren ()
 Reset cached content for children. More...
 
bool hasCacheResult () const
 Tell if node should cache its result. More...
 
bool hasFinalCompositionTarget () const
 Tell if node has final composition target. More...
 
bool isCacheResultValid () const
 Tell if children cache is valid. More...
 
void resetCacheResult ()
 Reset cached content for complete node content including itself and its children. More...
 
bool hasCacheSelf () const
 Tell if node should cache itself. More...
 
bool hasCacheSelfCompositionTarget () const
 Tell if node has cache children composition target. More...
 
bool isCacheSelfValid () const
 Tell if children cache is valid. More...
 
void resetCacheSelf ()
 Reset cached content for node itself. More...
 
CompositionManagergetCompositionManager () const
 Access composition manager. More...
 
NodeCompositor2DgetCompositor () const
 Access compositor component. More...
 
void setAutoWidth ()
 Sets node to automatically determine width. More...
 
void setAutoHeight ()
 Sets node to automatically determine height. More...
 
void setAutoSize ()
 Sets node to automatically determine both width and height. More...
 
void setSize (float width, float height)
 Sets size properties of the node. More...
 
void setLayoutSize (float width, float height)
 Sets size properties of the node. More...
 
SRTValue2D getLayoutTransformation () const
 Gets the value of LayoutTransformationProperty. More...
 
void setLayoutTransformation (SRTValue2D value)
 Sets the value of LayoutTransformationProperty. More...
 
Vector2 getDesiredSize () const
 Get desired size. More...
 
void setDesiredSize (Vector2 size)
 Set desired size. More...
 
Vector2 getAllocatedSize () const
 Get allocated size. More...
 
void setAllocatedSize (Vector2 allocatedSize)
 Set allocated size. More...
 
Vector2 getActualSize () const
 Get actual size. More...
 
void setActualSize (Vector2 actualSize)
 Set actual size. More...
 
void setActualSize (float sizeX, float sizeY)
 Set actual size. More...
 
Matrix3x3 getArrangeTransform () const
 Get arrange transform. More...
 
void setArrangeTransform (Matrix3x3 transform)
 Set arrange transform. More...
 
void layout (optional< Matrix3x3 > rootTransform)
 Does layout pass starting from this node and iterating recursively all of its children. More...
 
void layout ()
 Does layout pass with no root transformation (identity). More...
 
bool measure (const Vector2 *availableSize, bool handleStretch)
 Measure one node. More...
 
virtual bool measureRecursive ()
 Perform measure recursively. More...
 
void arrange ()
 Arrange one Node2D. More...
 
void extract ()
 Extract one Node2D. More...
 
Matrix3x3 getWorldTransform () const
 Get world transform. More...
 
bool containsLocal (Vector2 point) const
 Tell if a node area contains a point (defined in node's own space). More...
 
optional< Vector2containsGlobal (Vector2 point) const
 Tell if a node area contains a point (defined in screen space). More...
 
optional< Vector2globalToLocal (Vector2 point) const
 
NodeSharedPtr hitTest (Vector2 point)
 Performs a hit test to a 2D node and all its child nodes. More...
 
NodeSharedPtr hitTest (Vector2 point, const Metaclass *type)
 Performs a hit test to a 2D node and all its child nodes. More...
 
NodeSharedPtr hitTestIterate (Vector2 point, HitTestVisitor visitor, void *userData)
 Recursively hit test nodes from this node downwards and call visitor function on nodes hit. More...
 
virtual tuple< NodeSharedPtr, KzcRay, float > hitTestContent (Vector2 point)
 Default implementation of Node2D content hit test. More...
 
template<typename T >
shared_ptr< T > hitTest (Vector2 point)
 Wrapper for hitTest(Vector2), casts the return value. More...
 
template<typename T >
shared_ptr< T > hitTest (Vector2 point, const Metaclass *type)
 Wrapper for hitTest(Vector2, const Metaclass), casts the return value. More...
 
virtual NodeSharedPtr findAbstractChildOverride (string_view name) KZ_OVERRIDE
 Node::findAbstractChildOverride() implementation. More...
 
virtual VisitorResult visitAbstractChildOverride (const Visitor &visitor, VisitorOrder order) KZ_OVERRIDE
 Node::visitAabstractChild implementation. More...
 
virtual bool addAbstractChildOverride (NodeSharedPtr child) KZ_OVERRIDE
 Node::addAbstractChildOverride() implementation. More...
 
virtual size_t getAbstractChildCountOverride () KZ_OVERRIDE
 Node::getAbstractChildCountOverride() implementation. More...
 
virtual NodeSharedPtr getAbstractChildOverride (size_t index) KZ_OVERRIDE
 Node::getAbstractChildOverride() implementation. More...
 
virtual bool removeAbstractChildOverride (Node &child) KZ_OVERRIDE
 Node::removeAbstractChildOverride() implementation. More...
 
bool compositionRequiresAlpha () const
 Tell if composition requires alpha. More...
 
void setCompositionRequiresAlpha (bool enabled)
 Turn composition alpha requirement on or off. More...
 
bool compositionRequiresDepth () const
 Tell if composition requires depth. More...
 
void setCompositionRequiresDepth (bool enabled)
 Turn composition depth requirement on or off. More...
 
bool compositionRequiresStencil () const
 Tell if composition requires stencil. More...
 
void setCompositionRequiresStencil (bool enabled)
 Turn composition stencil requirement on or off. More...
 
QuadDescription getBackgroundQuad () const
 Gets the background quad description. More...
 
ClippingArea getClippingArea () const
 Get clipping area. More...
 
float getLayoutOpacity () const
 Get opacity after propagation from layouting hierarchy. More...
 
Matrix3x3 getRenderQuadTransform () const
 Gets transformation used to render the 2D node. More...
 
bool hasCenterClipArea () const
 Tell if Node2D has the center clip area (the area of itself). More...
 
bool hasOutsideClipArea () const
 Tell if Node2D has outside clipping area. More...
 
bool hasTranslucentForeground () const
 Tell if Node2D foreground has translucency. More...
 
void setForegroundIsTranslucent (bool enabled)
 Set foreground translucency status. More...
 
void setFinalCompositionRequested (bool enabled)
 Turn composition request on or off. More...
 
bool isCompositionClearColorRequired () const
 Indicates whether composition target requires color clear before rendering. More...
 
bool isClearColorAllowed () const
 Indicates whether this Node2D is allowed and should clear the color buffer of its own composition target. More...
 
void setClearColorAllowed (bool enabled)
 Set clear color allowed. More...
 
bool isRenderChildrenAllowed () const
 Tell if rendering children is allowed. More...
 
bool isRenderSelfAllowed () const
 Tell if render self is allowed. More...
 
bool isVisibleForHitTesting () const
 Tell if Node2D is visible for hit testing. More...
 
bool requiresBackgroundBrushRendering () const
 Tell if background brush rendering is required. More...
 
bool requiresForegroundBrushRendering () const
 Tell if foreground brush rendering is required. More...
 
bool hasChildrenRequireExtract () const
 Tell if children require extract flag is on. More...
 
void setChildrenRequireExtract (bool enabled)
 Set children require extract flag. More...
 
bool requiresExtract () const
 Tell if node requires extraction. More...
 
void setRequiresExtract (bool enabled)
 Turn extract requirement on or off. More...
 
bool isSelfInCompositionTarget () const
 Tell if node itself is going to get rendered into a composition target. More...
 
Vector2 getContentDesiredSize () const
 Get size desired by content. More...
 
Vector2 getSecondPassDesiredSize () const
 Get second pass desired size. More...
 
Vector2 getUserDesiredSize () const
 Get size desired by user. More...
 
Matrix3x3 getPartialArrangeTransform () const
 Get partial arrange transform. More...
 
bool isCompletelyClipped () const
 Tell if node is completely clipped (and needs not be rendered). More...
 
bool isCompletelyTransparent () const
 Tell if node is completely transparent. More...
 
float getAspectRatio () const
 Gets the value of AspectRatioProperty. More...
 
void setAspectRatio (float value)
 Sets the value of AspectRatioProperty. More...
 
bool isForceComposition () const
 Gets the value of ForceCompositionProperty. More...
 
void setForceComposition (bool value)
 Sets the value of ForceCompositionProperty. More...
 
Node2D::ForegroundHint getForegroundHint () const
 Gets the value of ForegroundHintProperty. More...
 
void setForegroundHint (Node2D::ForegroundHint value)
 Sets the value of ForegroundHintProperty. More...
 
bool isCacheChildren () const
 Gets the value of CacheChildrenProperty. More...
 
void setCacheChildren (bool value)
 Sets the value of CacheChildrenProperty. More...
 
bool isCacheResult () const
 Gets the value of CacheResultProperty. More...
 
void setCacheResult (bool value)
 Sets the value of CacheResultProperty. More...
 
bool isCacheSelf () const
 Gets the value of CacheSelfProperty. More...
 
void setCacheSelf (bool value)
 Sets the value of CacheSelfProperty. More...
 
bool isOffscreenRendering () const
 Gets the value of OffscreenRenderingProperty. More...
 
void setOffscreenRendering (bool value)
 Sets the value of OffscreenRenderingProperty. More...
 
bool isDisableRenderTargetClear () const
 Gets the value of DisableRenderTargetClearProperty. More...
 
void setDisableRenderTargetClear (bool value)
 Sets the value of DisableRenderTargetClearProperty. More...
 
Node2D::PixelFormat getPixelFormat () const
 Gets the value of PixelFormatProperty. More...
 
void setPixelFormat (Node2D::PixelFormat value)
 Sets the value of PixelFormatProperty. More...
 
bool isRenderSelf () const
 Gets the value of RenderSelfProperty. More...
 
void setRenderSelf (bool value)
 Sets the value of RenderSelfProperty. More...
 
float getRenderTargetMinimumHeight () const
 Gets the value of RenderTargetMinimumHeightProperty. More...
 
void setRenderTargetMinimumHeight (float value)
 Sets the value of RenderTargetMinimumHeightProperty. More...
 
float getRenderTargetMinimumWidth () const
 Gets the value of RenderTargetMinimumWidthProperty. More...
 
void setRenderTargetMinimumWidth (float value)
 Sets the value of RenderTargetMinimumWidthProperty. More...
 
float getRenderTargetReallocationLimit () const
 Gets the value of RenderTargetReallocationLimitProperty. More...
 
void setRenderTargetReallocationLimit (float value)
 Sets the value of RenderTargetReallocationLimitProperty. More...
 
Vector2 getRenderTransformationOrigin () const
 Gets the value of RenderTransformationOriginProperty. More...
 
void setRenderTransformationOrigin (Vector2 value)
 Sets the value of RenderTransformationOriginProperty. More...
 
bool isSnapToPixel () const
 Gets the value of SnapToPixelProperty. More...
 
void setSnapToPixel (bool value)
 Sets the value of SnapToPixelProperty. More...
 
- Public Member Functions inherited from kanzi::Node
virtual ~Node ()
 Destructor. More...
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getProperty (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property. More...
 
AbstractPropertyTypeDescriptor::ValueSourcegetNodeFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
template<typename DataType >
optional< typename PropertyType< DataType >::Traits::ReturnType > getOptionalProperty (const PropertyType< DataType > &propertyType) const
 Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value. More...
 
template<typename DataType >
DataType getAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename DataType >
optional< typename PropertyType< DataType >::DataType > getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename TMessageType , typename TClass , typename TClassMethod >
MessageSubscriptionToken addMessageHandler (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method)
 Adds a message handler where handler is a method to invoke on an object. More...
 
template<typename TMessageType , typename TClass , typename TClassMethod >
MessageSubscriptionToken addMessageFilter (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method)
 Adds a message filter where filter is a method to invoke on an object. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function)
 Adds a message handler where handler is function. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageFilter (const TMessageType &messageType, typename TMessageType::FunctionType function)
 Adds a message filter where filter is function. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function, Node *messageSourceFilter)
 Adds a message handler where handler is function and accepted source is explicitly defined. More...
 
void removeMessageHandler (MessageSubscriptionToken token)
 Removes a message subscription. More...
 
template<typename TArgumentsType >
void dispatchMessage (const MessageType< TArgumentsType > &messageType, typename MessageType< TArgumentsType >::ArgumentsType &messageArguments)
 Dispatches a message with specified arguments. More...
 
void addResource (const ResourceID &resourceId, string_view resourceUrl)
 Adds a resource manager resource to an object node. If resourceID already exists in object, removes the existing entry. If resourceURL is NULL, error is thrown. */. More...
 
void removeResource (const ResourceID &resourceId)
 Removes a resource with given ID from object node resource dictionary. Does not do anything if resourceID was not found. */. More...
 
bool containsResource (const ResourceID &resourceID) const
 Returns if object node resource dictionary contains the resource with given ID. Resource can be any type: style, alias or resource manager resource. */. More...
 
optional< string > findResourceURL (const ResourceID &resourceId) const
 Tries to find Resource URL for Resource ID from this node. More...
 
ResourceSharedPtr acquireResource (const ResourceID &id) const
 Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary. More...
 
template<typename T >
shared_ptr< T > acquireResource (const ResourceID &id) const
 Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary, and casts the resource to given type. More...
 
ResourceSharedPtr tryAcquireResource (const ResourceID &id) const
 Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary. More...
 
ResourceManager::AcquireTaskSharedPtr acquireResourceAsync (const ResourceID &key, ResourceManager::AsyncAcquireFinishedCallback func) const
 Posts an asynchronous task to acquire a resource. More...
 
template<typename T >
shared_ptr< T > tryAcquireResource (const ResourceID &id) const
 Acquires a resource from the node or the node's closest ancestor having the resource and casts the resource to given type. More...
 
ResourceDictionarySharedPtr getResourceDictionary () const
 Gets the resource dictionary of the node, if the node has one. More...
 
ResourceDictionarySharedPtr acquireResourceDictionary ()
 Gets the resource dictionary of the node. More...
 
void notifyResourceDictionaryModified ()
 Forces the re-evaluation of resource IDs in a node tree. More...
 
void setResourceDictionary (ResourceDictionarySharedPtr resourceDictionary)
 Replaces the resource dictionary of the node. More...
 
void addResourceDictionary (ResourceDictionarySharedPtr resourceDictionary)
 Add a nested resource dictionary to the resource dictionary of the node. More...
 
void addAnonymousResource (ResourceSharedPtr resource)
 Adds alias resource to an object node. More...
 
void removeAnonymousResource (const Resource &resource)
 Removes anonymous resource from object node resources. More...
 
bool isNamed (string_view name) const
 
NodegetParent () const
 Returns the parent of the node. More...
 
void setParent (Node *parent)
 
VisitorResult visit (const Visitor &visitor, VisitorOrder order)
 
VisitorResult visitDescendants (const Visitor &visitor, VisitorOrder order)
 
template<typename Type >
shared_ptr< Type > lookupNode (string_view pathOrKey)
 Returns a node of specified type by looking it up with specified path or alias. More...
 
NodelookupNodeRaw (string_view relativePath)
 Get an object node by another node and a relative path. More...
 
ObjectSharedPtr lookupObject (string_view relativePath)
 Lookup for an object from a node. More...
 
tuple< NodeSharedPtr, AbstractPropertyTypelookupObjectForStateManager (string_view relativePath)
 Lookup for an node and possible object from within the node for state manager. More...
 
template<typename Type >
shared_ptr< Type > lookupObject (string_view path)
 Lookup for an object from a node. More...
 
template<typename TNodeType >
shared_ptr< TNodeType > findAbstractChild (string_view name)
 Find a child by name. Finds direct children as well as children connected indirectly for example Viewport->Scene. More...
 
void addInputManipulator (InputManipulatorSharedPtr inputManipulator)
 Transfers the ownership and attaches an input manipulator to an object node. More...
 
void removeInputManipulator (InputManipulator &inputManipulator)
 Removes the ownership and detaches an input manipulator from an object node. More...
 
InputManipulatorConstIterator beginInputManipulators () const
 
InputManipulatorConstIterator endInputManipulators () const
 
void addBinding (BindingSharedPtr binding)
 Transfers the ownership of a binding rule to an object node. More...
 
void addBindingWithOwner (BindingSharedPtr binding, shared_ptr< void > owner)
 Transfers the ownership of a binding rule to an object node and sets the owner of binding rule. More...
 
void removeBinding (Binding &binding)
 Removes the ownership and detaches a binding rule from an object node. More...
 
void removeBindingsWithOwner (shared_ptr< void > owner)
 Removes all bindings with the specified owner. More...
 
BindingConstIterator beginBindings () const
 
BindingConstIterator endBindings () const
 
void addNodeComponent (NodeComponentSharedPtr nodeComponent)
 Transfers the ownership of a node component to an object node. More...
 
void addNodeComponentWithOwner (NodeComponentSharedPtr nodeComponent, const void *owner)
 Transfers the ownership of a node component to an object node and sets the owner of the node component. More...
 
void removeNodeComponent (NodeComponent &nodeComponent)
 Removes the ownership of a node component from an object node. More...
 
void removeNodeComponentWithOwner (const void *owner)
 Removes all bindings with the specified owner. More...
 
NodeComponentConstIterator beginNodeComponents () const
 
NodeComponentConstIterator endNodeComponents () const
 
template<typename Type >
shared_ptr< Type > lookupNodeComponent (string_view name)
 Returns a node component of specified type by looking it up with specified name. More...
 
void setRenderable (bool state)
 Sets whether the object node is renderable. More...
 
bool isRenderable () const
 Returns whether node is renderable. More...
 
bool isEffectivelyVisible () const
 Checks if the node and all of its ancestors are visible. More...
 
bool isEffectivelyEnabled () const
 Checks if the node and all of its ancestors are enabled. More...
 
uint32_t getChangeFlags () const
 Get current change flags. More...
 
uint32_t getChildChangeFlags () const
 Get current child change flags. More...
 
void setChangeFlag (uint32_t flag)
 Sets a change flag. More...
 
void clearChangeFlag (uint32_t flag)
 Clears a change flag. More...
 
bool isChangeFlagSet (uint32_t flag) const
 Checks if a change flag is set. More...
 
bool isAnyChangeFlagSet (uint32_t flag) const
 Checks if any of given flags is set. More...
 
void setChildChangeFlag (uint32_t flag)
 Sets a child change flag. More...
 
void clearChildChangeFlag (uint32_t flag)
 Clears a child change flag. More...
 
bool isChildChangeFlagSet (uint32_t flag) const
 Checks if child change flags match. More...
 
bool isAnyChildChangeFlagSet (uint32_t flag) const
 Checks if any child change flags (corresponding to given mask) are set. More...
 
bool isInvalidMeasure () const
 Check if the node needs measure. More...
 
void invalidateMeasure ()
 Invalidates measure for the node. More...
 
void validateMeasure ()
 Validates measure for the node. More...
 
bool isInvalidArrange () const
 Checks if the node needs arrange. More...
 
void invalidateArrange ()
 Invalidates arrange. More...
 
void validateArrange ()
 Validates arrange. More...
 
bool isInvalidRender () const
 Returns if node render flag is invalid. More...
 
void validateRender ()
 Validates render for node. More...
 
void invalidateRender ()
 Invalidates render for node. More...
 
bool isInvalidFinalTransform () const
 Tells if final transform flag is invalid for node. More...
 
void invalidateFinalTransform ()
 Invalidates final transform for node. More...
 
bool isInvalidDraw ()
 Tells if node draw flag is invalid. More...
 
void invalidateDraw ()
 Invalidates draw flag for the node. More...
 
void validateDraw ()
 Validates draw flags for the node. More...
 
void validateDrawForChildrenRecursive ()
 Recursively validates draw for the children from this 2D node onwards. More...
 
bool isInitialized () const
 Returns true if initialize() has been called, false otherwise. More...
 
bool isAttached () const
 Returns true if the node is attached to a screen or one of its descendants. More...
 
bool isAttaching () const
 Returns true if node is in the process of attaching, false otherwise. More...
 
bool isDetaching () const
 Returns true if the node currently detaching. More...
 
void attachRecursive ()
 Attaches an object node and its children recursively. More...
 
void detachRecursive ()
 Detaches an object node and its children recursively. More...
 
virtual const KzuBoundingVolumegetBoundingVolume () const
 Gets bounding volume from object node. More...
 
AppliedStyleEntrySharedPtr applyStyle (StyleSharedPtr style)
 Applies a style to an object node. More...
 
AppliedStyleEntrySharedPtr applyManualStyle (StyleSharedPtr style)
 Applies a style to an object node. More...
 
void unapplyStyle (AppliedStyleEntrySharedPtr appliedStyleEntry)
 Unapplies a style from an object node. More...
 
void applyStyles ()
 Apply all styles for an object node. More...
 
void unapplyStyles ()
 Unapplies and removes all applied styles. More...
 
void applyStylesRecursive ()
 Applies styles recursively. More...
 
void unapplyStylesRecursive ()
 Unapplies styles recursively. More...
 
void removeKZBData ()
 Destroys all object node data loaded from KZB, including properties, bindings, node comopnents, resources etc. More...
 
void addResourceReference (AbstractPropertyType propertyType, AbstractResourceReference *reference)
 This is a helper for automatic resource tracking in ResourceReference. More...
 
void removeResourceReference (const AbstractResourceReference &reference)
 This is a helper for automatic resource tracking in ResourceReference. More...
 
void addNodeReference (AbstractPropertyType propertyType, AbstractNodeReference *reference)
 
void removeNodeReference (const AbstractNodeReference &reference)
 
ScriptingContextSharedPtr getScriptingContext () const
 
void setScriptingContext (ScriptingContextSharedPtr context)
 
void setTemplateRoot (NodeSharedPtr templateRoot)
 Sets the template root of this node. More...
 
NodeSharedPtr getTemplateRoot () const
 Gets the template root of this node. More...
 
bool trySetActiveFocus ()
 The method tries to move the active focus on this node. More...
 
string getName () const
 Gets the value of NameProperty. More...
 
void setName (string_view value)
 Sets the value of NameProperty. More...
 
string getPath () const
 Gets the value of PathProperty. More...
 
void setPath (string value)
 Sets the value of PathProperty. More...
 
string getLocale () const
 Gets the value of LocaleProperty. More...
 
void setLocale (string value)
 Sets the value of LocaleProperty. More...
 
bool isHitTestable () const
 Gets the value of HitTestableProperty. More...
 
void setHitTestable (bool value)
 Sets the value of HitTestableProperty. More...
 
bool isHitTestableContainer () const
 Gets the value of HitTestableContainerProperty. More...
 
void setHitTestableContainer (bool value)
 Sets the value of HitTestableContainerProperty. More...
 
bool isVisible () const
 Gets the value of VisibleProperty. More...
 
void setVisible (bool value)
 Sets the value of VisibleProperty. More...
 
bool isEnabled () const
 Gets the value of EnabledProperty. More...
 
void setEnabled (bool value)
 Sets the value of EnabledProperty. More...
 
bool isFocusable () const
 Gets the value of FocusableProperty. More...
 
void setFocusable (bool value)
 Sets the value of FocusableProperty. More...
 
bool isFocused () const
 Gets the value of FocusedProperty. More...
 
void setFocused (bool value)
 Sets the value of FocusedProperty. More...
 
bool hasLogicalFocus () const
 Returns the #LogicalFocusedProperty value. More...
 
void setLogicalFocus (bool value)
 Sets the value of LogicalFocusProperty. More...
 
FontSharedPtr getFont () const
 Gets the value of FontProperty. More...
 
void setFont (FontSharedPtr value)
 Sets the value of FontProperty. More...
 
float getVisibleAmountInParent () const
 Gets the value of VisibleAmountInParentProperty. More...
 
void setVisibleAmountInParent (float value)
 Sets the value of VisibleAmountInParentProperty. More...
 
float getProjection2DTo3DScale () const
 Gets the value of Projection2DTo3DScaleProperty. More...
 
void setProjection2DTo3DScale (float value)
 Sets the value of Projection2DTo3DScaleProperty. More...
 
bool isEnableClick () const
 Gets the value of EnableClickProperty. More...
 
void setEnableClick (bool value)
 Sets the value of EnableClickProperty. More...
 
bool isEnableMultiClick () const
 Gets the value of EnableMultiClickProperty. More...
 
void setEnableMultiClick (bool value)
 Sets the value of EnableMultiClickProperty. More...
 
ResourceSharedPtr getStyle () const
 Gets the value of StyleProperty. More...
 
void setStyle (ResourceSharedPtr value)
 Sets the value of StyleProperty. More...
 
ResourceSharedPtr getStateManager () const
 Gets the value of StateManagerProperty. More...
 
void setStateManager (ResourceSharedPtr value)
 Sets the value of StateManagerProperty. More...
 
float getWidth () const
 Gets the value of WidthProperty. More...
 
void setWidth (float value)
 Sets the value of WidthProperty. More...
 
float getHeight () const
 Gets the value of HeightProperty. More...
 
void setHeight (float value)
 Sets the value of HeightProperty. More...
 
float getDepth () const
 Gets the value of DepthProperty. More...
 
void setDepth (float value)
 Sets the value of DepthProperty. More...
 
float getActualWidth () const
 Gets the value of ActualWidthProperty. More...
 
void setActualWidth (float value)
 Sets the value of ActualWidthProperty. More...
 
float getActualHeight () const
 Gets the value of ActualHeightProperty. More...
 
void setActualHeight (float value)
 Sets the value of ActualHeightProperty. More...
 
float getActualDepth () const
 Gets the value of ActualDepthProperty. More...
 
void setActualDepth (float value)
 Sets the value of ActualDepthProperty. More...
 
Node::HorizontalAlignment getHorizontalAlignment () const
 Gets the value of HorizontalAlignmentProperty. More...
 
void setHorizontalAlignment (Node::HorizontalAlignment value)
 Sets the value of HorizontalAlignmentProperty. More...
 
Node::VerticalAlignment getVerticalAlignment () const
 Gets the value of VerticalAlignmentProperty. More...
 
void setVerticalAlignment (Node::VerticalAlignment value)
 Sets the value of VerticalAlignmentProperty. More...
 
Node::DepthAlignment getDepthAlignment () const
 Gets the value of DepthAlignmentProperty. More...
 
void setDepthAlignment (Node::DepthAlignment value)
 Sets the value of DepthAlignmentProperty. More...
 
Vector2 getHorizontalMargin () const
 Gets the value of HorizontalMarginProperty. More...
 
void setHorizontalMargin (Vector2 value)
 Sets the value of HorizontalMarginProperty. More...
 
Vector2 getVerticalMargin () const
 Gets the value of VerticalMarginProperty. More...
 
void setVerticalMargin (Vector2 value)
 Sets the value of VerticalMarginProperty. More...
 
Vector2 getDepthMargin () const
 Gets the value of DepthMarginProperty. More...
 
void setDepthMargin (Vector2 value)
 Sets the value of DepthMarginProperty. More...
 
Node::ContentStretch getContentStretch () const
 Gets the value of ContentStretchProperty. More...
 
void setContentStretch (Node::ContentStretch value)
 Sets the value of ContentStretchProperty. More...
 
float getOpacity () const
 Gets the value of OpacityProperty. More...
 
void setOpacity (float value)
 Sets the value of OpacityProperty. More...
 
bool isHover () const
 Returns whether the node has HoverProperty set to true. More...
 
bool isClipChildren () const
 Gets the value of ClipChildrenProperty. More...
 
void setClipChildren (bool value)
 Sets the value of ClipChildrenProperty. More...
 
- Public Member Functions inherited from kanzi::Object
 Object (Domain *domain)
 
virtual ~Object ()
 
DomaingetDomain () const
 Returns the domain the object belongs to. More...
 
KzuTaskSchedulergetTaskScheduler () const
 Returns the task scheduler of the object. More...
 
KzuMessageDispatchergetMessageDispatcher () const
 Returns the message dispatcher of the object. More...
 
ResourceManagergetResourceManager () const
 Returns the resource manager of the object. More...
 
virtual const MetaclassgetDynamicMetaclass () const KZ_OVERRIDE
 Returns the metaclass of the dynamic type of the object. More...
 
AppliedStyleEntrySharedPtr applyObjectStyle (kanzi::StyleSharedPtr style)
 Applies a style to an object. More...
 
void unapplyObjectStyle (AppliedStyleEntrySharedPtr appliedStyleEntry)
 
void applyObjectStyles ()
 Apply all styles for an object node. More...
 
void unapplyObjectStyles ()
 Unapplies and removes all applied styles. More...
 
- Public Member Functions inherited from kanzi::MetaObject
virtual ~MetaObject ()
 
bool isTypeOf (const Metaclass *objectType) const
 Determines if the type of this object is the given type or derived from it. More...
 
- Public Member Functions inherited from kanzi::PropertyObject
 PropertyObject ()
 
virtual ~PropertyObject ()
 
template<typename DataType >
void setProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Traits::ParameterType value)
 Sets the local value of a property. More...
 
void removeKzbProperties ()
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getProperty (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property. More...
 
template<typename DataType >
optional< typename PropertyType< DataType >::Traits::ReturnType > getOptionalProperty (const PropertyType< DataType > &propertyType) const
 Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value. More...
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getPropertyBase (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property disregarding modifiers. More...
 
template<typename DataType >
void setAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::Traits::ParameterType value)
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getAbstractPropertyBase (AbstractPropertyType abstractPropertyType) const
 
template<typename DataType >
optional< typename PropertyType< DataType >::Traits::ReturnType > getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
void setPropertyFlag (AbstractPropertyType propertyType, uint32_t flag)
 
bool isPropertyFlagSet (AbstractPropertyType propertyType, uint32_t flag) const
 
void clearPropertyFlag (AbstractPropertyType propertyType, uint32_t flag)
 
bool hasValue (AbstractPropertyType propertyType) const
 Evaluates whether there are any inputs into the property value. More...
 
bool hasBaseValue (AbstractPropertyType propertyType) const
 Evaluates whether there are any inputs into the property value, disregarding modifiers. More...
 
bool hasLocalValue (AbstractPropertyType propertyType) const
 Evaluates whether there is a local value set for the property. More...
 
bool hasNonClassValue (AbstractPropertyType propertyType) const
 Evaluates whether there is a value of any precedence higher than class default value set for the property. More...
 
void removeLocalValue (AbstractPropertyType propertyType)
 Removes the local value associated with the property. More...
 
void copyLocalValue (const PropertyObject &other, AbstractPropertyType propertyType)
 Copies local value of single property from another object. More...
 
void copyLocalValues (const PropertyObject &other)
 Copies all local values from another object. More...
 
template<typename DataType >
void addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, void *owner)
 
template<typename DataType >
void removePropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *owner)
 
template<typename DataType >
void addPropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner)
 
template<typename DataType >
void removePropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner)
 
void validatePropertyModifiers (AbstractPropertyType propertyType)
 
template<typename DataType >
void addPropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner)
 
template<typename DataType >
void removePropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner)
 
template<typename DataType >
size_t getPropertyNotificationHandlerCount (const PropertyType< DataType > &propertyType)
 Gets number of current notification handlers for given property type. More...
 
- Public Member Functions inherited from kanzi::ContentItemCollectionModel
virtual ~ContentItemCollectionModel ()
 

Static Public Member Functions

static GridListBox2DSharedPtr create (Domain *domain, string_view name)
 Creates a grid listbox node. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >
static Vector2 doMeasure (Node2D &node)
 
static Vector3 doMeasure (Node3D &node)
 
- Static Public Member Functions inherited from kanzi::Node2D
static float layoutUp ()
 
static bool isValidLayoutSize (Vector2 size)
 Indicates whether a size is valid layout size. More...
 
static Vector2 unboundedLayoutSize ()
 Returns an unbounded layout size. More...
 
static bool isUnboundedLayoutSize (Vector2 layoutSize)
 Indicates whether a layout size is an unbound layout size. More...
 
static Vector2 replaceUnboundedLayoutSize (Vector2 layoutSize, Vector2 resetSize)
 Replaces any element of a layout size with appropriate element of the reset size if it is unbounded and returns the size. More...
 
static Vector2 replaceUnboundedLayoutSizeWithZero (Vector2 layoutSize)
 Replaces any element of a layout size with zero if it is unbounded and returns the size. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::Node
static bool isValidLayoutValue (float value)
 Indicates whether a value is valid layout value. More...
 
static float unboundedLayoutValue ()
 Returns an unbounded layout value. More...
 
static bool isUnboundedLayoutValue (float layoutValue)
 Indicates whether a value is an unbound layout value. More...
 
static float replaceUnboundedLayoutValue (float layoutValue, float resetValue)
 Replaces layout value with the specified value if it is unbounded and returns it. More...
 
static float replaceUnboundedLayoutValueWithZero (float layoutValue)
 Replaces layout value with zero if it is unbounded layout value and returns it. More...
 
- Static Public Member Functions inherited from kanzi::Object
static const MetaclassgetStaticMetaclass ()
 Returns the metaclass of Object class. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 Default implementation that returns empty editor info. More...
 
- Static Public Member Functions inherited from kanzi::MetaObject
static const MetaclassgetStaticMetaclass ()
 Returns the metaclass of Object class. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 Default implementation that returns empty editor info. More...
 
- Static Public Member Functions inherited from kanzi::ListBoxConcept
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::GridListBoxConcept
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 

Protected Member Functions

 GridListBox2D (Domain *domain, string_view name)
 
void initialize ()
 
void setInitialScrollPosition ()
 
virtual void onAttached () KZ_OVERRIDE
 Node::onAttached() implementation. More...
 
- Protected Member Functions inherited from kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >
 ListBoxConceptImpl (Domain *domain, string_view name)
 
 ~ListBoxConceptImpl ()
 
void initialize (ScrollViewSharedPtr scroll, PresenterSharedPtr pres)
 
void onClicked (ClickManipulator::ClickMessageArguments &messageArguments)
 
void onScrolled (ScrollViewConcept::ScrolledMessageArguments &messageArguments)
 
void onScrollStarted (ScrollViewConcept::ScrollStartedMessageArguments &messageArguments)
 
void onScrollFinished (ScrollViewConcept::ScrollFinishedMessageArguments &messageArguments)
 
void onSnapRequested (ScrollViewConcept::SnapRequestMessageArguments &messageArguments)
 
void sendScrollViewScrollTargetMessage (const Vector2 &scrollTarget)
 Sends new scroll target to scroll view. More...
 
void sendSetScrollViewScrollMessage (const Vector2 &scrollPosition)
 Sends new current scroll position to scroll view. More...
 
void sendListBoxTargetChangedMessage (size_t targetItem)
 Sends new current scroll position to scroll view. More...
 
virtual void onDetached () KZ_OVERRIDE
 Node::onDetached() implementation. More...
 
virtual void onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) KZ_OVERRIDE
 Node::onNodePropertyChanged() implementation. More...
 
void applySelectionBehavior (size_t itemIndex, bool smooth)
 Applies selection behavior to specified item. More...
 
void assignItemGenerator (ItemGeneratorSharedPtr itemGenerator)
 Assigns list box item generator to list box. More...
 
void setItemGeneratorByProperty ()
 Creates and assigns item generator by ItemGeneratorTypeName property value. More...
 
void assignItemContainerGenerator (ItemContainerGeneratorSharedPtr itemContainerGenerator)
 Assigns list box item container generator to list box. More...
 
void setItemContainerGeneratorByProperty ()
 Creates and assigns item container generator by ItemGeneratorTypeName property value. More...
 
void updateGenerators (ItemGeneratorSharedPtr itemGenerator, ItemContainerGeneratorSharedPtr itemContainerGenerator)
 Replaces item and item container generators with new objects. Updates items and layout accordingly. More...
 
void synchronizeSelectedItemIndexProperty ()
 Updates SelectedItemIndex property after selected item index changes internally by list box. More...
 
- Protected Member Functions inherited from kanzi::Node2D
 Node2D (Domain *domain, string_view name)
 Constructor. More...
 
void initialize ()
 
NodeVisual2DacquireVisual ()
 Initializes and returns visual structure. More...
 
virtual void renderOverride (Renderer3D &renderer, CompositionStack &compositionStack)
 Node-specific top-level render call. More...
 
void renderRecursive (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Render a Node2D and then recursively all its children. More...
 
virtual void renderSelfOverride (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Node-specific rendering. More...
 
void renderChildren (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Render all children of a Node2D. More...
 
void renderBackground (Renderer3D &renderer, const CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Render background quad of a Node2D. More...
 
void renderForeground (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Render foreground of a Node2D. More...
 
virtual void renderForegroundOverride (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &baseTransform)
 Node-specific foreground render. More...
 
bool pushLocalViewportArea (CompositionStack &compositionStack)
 Push local viewport and scissor area into composition stack if it's required. More...
 
NodeCompositor2DacquireCompositor ()
 Initializes and returns composition structure. More...
 
void clearCompositionTarget (Renderer3D &renderer, CompositionStack &compositionStack, bool clearColor)
 Clear node render target. More...
 
virtual void arrangeRecursive (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform, bool arrangeNeeded, bool transformChanged)
 Perform arrange recursively. More...
 
optional< float > getUserAspectRatio () const
 Get aspect ratio property assigned to the node. More...
 
optional< float > getUserHeight () const
 Get layout height property assigned to the node. More...
 
optional< float > getUserWidth () const
 Get layout width property assigned to the node. More...
 
Vector2 getDesiredSizeAxisAlignedBoundingBoxMinimum () const
 Get desired size axis aligned bounding box minimum. More...
 
void setDesiredSizeAxisAlignedBoundingBoxMinimum (Vector2 size)
 Set desired size axis aligned bounding box minimum. More...
 
void setDesiredSizeAxisAlignedBoundingBoxMinimum (float sizeX, float sizeY)
 Set desired size axis aligned bounding box minimum. More...
 
Vector2 getDesiredSizeAxisAlignedBoundingBoxMaximum () const
 Get desired size axis aligned bounding box maximum. More...
 
void setDesiredSizeAxisAlignedBoundingBoxMaximum (Vector2 size)
 Set desired size axis aligned bounding box maximum. More...
 
void setDesiredSizeAxisAlignedBoundingBoxMaximum (float sizeX, float sizeY)
 Set desired size maximum. More...
 
void calculateTransformedBoundingArea (const Matrix3x3 &transform, Vector2 sizeIn)
 Calculate new transformed bounding area. More...
 
Matrix3x3 updateFinalTransform (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform)
 Update final transformation. More...
 
bool updateRender (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform, bool transformChanged)
 Validate node for rendering. More...
 
virtual void updateRenderOverride ()
 Node-specific updates done before render. More...
 
optional< QuadDescriptioncalculateContentStretch (Vector2 renderSize, Vector2 contentSize)
 Calculate content stretch. More...
 
ClippingArea calculateClippingArea (const Matrix3x3 &parentSpaceTransform) const
 Calculate clipping parameters. More...
 
unsigned int performClipping (QuadDescription &backgroundQuad, optional< QuadDescription > &foregroundQuad, unsigned int clippingResult)
 Perform rectangle clipping. More...
 
void extractChildren () const
 Extract children of node, called from extraction implementations. More...
 
virtual void onExtract ()
 Node2D extract function. More...
 
virtual void restoreResources () KZ_OVERRIDE
 Node::restoreResources() implementation. More...
 
bool isEmptyActualSize () const
 Tell if the size of the node is empty or invalid. More...
 
bool isForegroundHintOpaque () const
 Tell if foreground hint is opaque. More...
 
bool isForegroundHintTranslucent () const
 Tell if foreground hint is translucent. More...
 
bool isForegroundTranslucencyRequested () const
 Tell if foreground translucency has been requested. More...
 
void setForegroundTranslucencyRequested (bool enabled)
 Turn foreground translucency request on or off. More...
 
void setPartialArrangeTransform (Matrix3x3 transform)
 Sets partial arrange transform. More...
 
void setRenderChildrenAllowed (bool enabled)
 Turn render children on or off. More...
 
void setRenderSelfAllowed (bool enabled)
 Turn render self on or off. More...
 
void setRenderType (RenderType renderType)
 Set render type. More...
 
void updateContentTexture (TextureSharedPtr texture)
 Update content texture for the foreground brush. More...
 
void setSecondPassDesiredSize (Vector2 size)
 Set second pass desired size. More...
 
- Protected Member Functions inherited from kanzi::Node
 Node (Domain *domain, string_view name)
 Constructor. More...
 
void initialize ()
 
void updatePropertiesForConnectedNode ()
 Invokes property notifications for inherited properties during scene graph tree connections. More...
 
void updatePropertiesForDisconnectedNode (Node *oldParent)
 Invokes property notifications for inherited properties during scene graph tree disconnections. More...
 
void updateResourceReferences ()
 
void updateResourceReferences (AbstractPropertyType propertyType)
 
void updateResourceReferencesRecursive ()
 
void updateResourceReferencesRecursive (const ResourceID &resourceID)
 
void attach ()
 Attaches the object node. More...
 
void detach ()
 Detaches the object node. More...
 
virtual void notifyPropertyHandlers (PropertyStoragePtr &propertyStorage, PropertyNotificationReason reason) KZ_OVERRIDE
 
- Protected Member Functions inherited from kanzi::Object
void initialize ()
 
void onCopy (const Object &other)
 
- Protected Member Functions inherited from kanzi::MetaObject
 MetaObject ()
 
void initialize ()
 
- Protected Member Functions inherited from kanzi::PropertyObject
void addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, void *owner)
 
void removePropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, void *owner)
 
AbstractPropertyTypeDescriptor::ValueSourceEntrygetTopValueSourceEntry (AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) const
 
AbstractPropertyTypeDescriptor::ValueSourceEntrygetTopValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetTopValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetNonClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourceEntryfindLocalValueSourceEntry (AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 
AbstractPropertyTypeDescriptor::ValueSourceEntryconstructLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 
AbstractPropertyTypeDescriptor::ValueSourceEntryacquireLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, PropertyStoragePtr &propertyStorage)
 
AbstractPropertyTypeDescriptor::PropertyStoragefindPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) const
 
PropertyStoragePtr findPropertyStoragePtr (AbstractPropertyTypeDescriptor &descriptor) const
 Gets property storage intrusive pointer that can be used to hold a reference until end of operation. More...
 
PropertyStoragePtr constructPropertyStorage (AbstractPropertyTypeDescriptor &descriptor)
 
PropertyStoragePtr acquirePropertyStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::ModifierStorageacquireModifierStorage (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 
AbstractPropertyTypeDescriptor::ModifierStoragefindModifierStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::NotificationStorageacquireNotificationStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::NotificationStoragefindNotificationStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptorfindPropertyTypeDescriptorByUnqualifiedNameAndDataType (string_view unqualifiedName, PropertyDataType dataType)
 
void validatePropertyModifiersAndNotifyHandlers (PropertyStoragePtr &propertyStorage)
 
void copyLocalValue (const AbstractPropertyTypeDescriptor::PropertyStorage &otherPropertyStorage)
 Copy local value from property storage. More...
 
PropertyStorageContainer::iterator beginPropertyStorage ()
 
PropertyStorageContainer::iterator endPropertyStorage ()
 
void onCopy (const PropertyObject &other)
 

Additional Inherited Members

- Public Types inherited from kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >
typedef GridListBox2DTraits::TScrollViewClass ScrollViewClass
 
typedef GridListBox2DTraits::TItemClass ItemClass
 
typedef GridListBox2DTraits::TItemContainerClass ItemContainerClass
 
typedef GridListBox2DTraits::TPresenterClass PresenterClass
 
typedef GridListBox2DTraits::TItemGeneratorClass ItemGeneratorClass
 
typedef GridListBox2DTraits::TItemContainerGeneratorClass ItemContainerGeneratorClass
 
typedef Node2D::LayoutVectorType LayoutVectorType
 
typedef shared_ptr< ScrollViewClassScrollViewSharedPtr
 
typedef shared_ptr< ItemClassItemSharedPtr
 
typedef shared_ptr< ItemContainerClassItemContainerSharedPtr
 
typedef shared_ptr< DefaultListBoxItemGenerator< ItemGeneratorClass > > DefaultItemGeneratorSharedPtr
 
typedef shared_ptr< ItemGeneratorClassItemGeneratorSharedPtr
 
typedef shared_ptr< ItemContainerGeneratorClassItemContainerGeneratorSharedPtr
 
typedef shared_ptr< PresenterClassPresenterSharedPtr
 
- Public Types inherited from kanzi::Node2D
enum  PixelFormat { PixelFormatRgb, PixelFormatRgba }
 
enum  ForegroundHint { ForegroundHintNone, ForegroundHintTranslucent, ForegroundHintOpaque }
 Hint for foreground handling of nodes. More...
 
enum  RenderType { RenderTypeNone, RenderTypeTexture, RenderTypeManual, RenderTypeManualClipped }
 Node2D render type - affects elementary decisions about node rendering. More...
 
typedef Vector2 LayoutVectorType
 
typedef Matrix3x3 LayoutMatrixType
 
typedef vector< Node2DSharedPtrChildContainer
 Container type for children. More...
 
typedef ChildContainer::const_iterator ChildConstIterator
 Iterator type for children. More...
 
typedef ChildContainer::const_reverse_iterator ChildConstReverseIterator
 Reverse iterator type for children. More...
 
typedef NodeSharedPtr(* HitTestVisitor) (Node2D &node, Vector2 nodePoint, void *userData)
 Hit test visitor function. More...
 
- Public Types inherited from kanzi::Node
enum  HorizontalAlignment { HorizontalAlignmentLeft, HorizontalAlignmentRight, HorizontalAlignmentCenter, HorizontalAlignmentStretch }
 Horizontal alignment options. More...
 
enum  VerticalAlignment { VerticalAlignmentBottom, VerticalAlignmentTop, VerticalAlignmentCenter, VerticalAlignmentStretch }
 Vertical alignment options. More...
 
enum  DepthAlignment { DepthAlignmentBack, DepthAlignmentFront, DepthAlignmentCenter, DepthAlignmentStretch }
 Depth alignment options. More...
 
enum  ContentStretch {
  ContentStretchNone, ContentStretchFill, ContentStretchUniform, ContentStretchUniformToFill,
  ContentStretchRepeat
}
 Content stretch option. More...
 
enum  VisitorOrder { VisitorPreOrder, VisitorPostOrder }
 
enum  VisitorResult { VisitorAbort, VisitorContinue, VisitorContinueSibling }
 
typedef kanzi::vector< Node::MessageSubscriptionTokenMessageSubscriptionTokenVector
 
typedef function< VisitorResult(Node &)> Visitor
 
typedef vector< InputManipulatorSharedPtrInputManipulatorContainer
 Gets the input manipulator iterator. More...
 
typedef InputManipulatorContainer::iterator InputManipulatorIterator
 
typedef InputManipulatorContainer::const_iterator InputManipulatorConstIterator
 
typedef vector< BindingEntryBindingContainer
 Gets the bindings iterator. More...
 
typedef BindingContainer::iterator BindingIterator
 
typedef BindingContainer::const_iterator BindingConstIterator
 
typedef vector< NodeComponentEntryNodeComponentContainer
 Gets the node component iterator. More...
 
typedef NodeComponentContainer::iterator NodeComponentIterator
 
typedef NodeComponentContainer::const_iterator NodeComponentConstIterator
 
- Public Types inherited from kanzi::PropertyObject
typedef intrusive_ptr< AbstractPropertyTypeDescriptor::PropertyStoragePropertyStoragePtr
 
typedef vector< PropertyStoragePtrPropertyStorageContainer
 
typedef PropertyStorageContainer::iterator PropertyStorageIterator
 
typedef PropertyStorageContainer::const_iterator PropertyStorageConstIterator
 
typedef PropertyStorageContainer::reverse_iterator PropertyStorageReverseIterator
 
- Public Types inherited from kanzi::ListBoxConcept
enum  SelectionBehavior { SelectionBehaviorNone, SelectionBehaviorBringToCenter }
 Behaviors for list box when an item in the list box is selected. More...
 
- Public Types inherited from kanzi::GridListBoxConcept
enum  GridDirection { GridDirectionRight, GridDirectionDown }
 
- Static Public Attributes inherited from kanzi::Node2D
static PropertyType< float > AspectRatioProperty
 AspectRatio property. More...
 
static PropertyType< bool > ForceCompositionProperty
 ForceComposition property. More...
 
static PropertyType< Node2D::ForegroundHintForegroundHintProperty
 ForegroundHint property. More...
 
static PropertyType< bool > CacheChildrenProperty
 CacheChildren property. More...
 
static PropertyType< bool > CacheResultProperty
 CacheResult property. More...
 
static PropertyType< bool > CacheSelfProperty
 CacheSelf property. More...
 
static PropertyType< bool > OffscreenRenderingProperty
 OffscreenRendering property. More...
 
static PropertyType< bool > DisableRenderTargetClearProperty
 DisableRenderTargetClear property. More...
 
static PropertyType< Node2D::PixelFormatPixelFormatProperty
 PixelFormat property. More...
 
static PropertyType< bool > RenderSelfProperty
 RenderSelf property. More...
 
static PropertyType< ResourceSharedPtrRenderTargetProperty
 RenderTarget property. More...
 
static PropertyType< float > RenderTargetMinimumHeightProperty
 RenderTargetMinimumHeight property. More...
 
static PropertyType< float > RenderTargetMinimumWidthProperty
 RenderTargetMinimumWidth property. More...
 
static PropertyType< float > RenderTargetReallocationLimitProperty
 RenderTargetReallocationLimit property. More...
 
static PropertyType< SRTValue2DLayoutTransformationProperty
 LayoutTransformation property. More...
 
static PropertyType< SRTValue2DRenderTransformationProperty
 RenderTransformation property. More...
 
static PropertyType< SRTValue3DPerspectiveTransformationProperty
 PerspectiveTransformation property. More...
 
static PropertyType< Vector2RenderTransformationOriginProperty
 RenderTransformationOrigin property. More...
 
static PropertyType< bool > SnapToPixelProperty
 SnapToPixel property. More...
 
static PropertyType< ResourceSharedPtrBackgroundBrushProperty
 BackgroundBrush property. More...
 
static PropertyType< ResourceSharedPtrCompositionBrushProperty
 CompositionBrush property. More...
 
static PropertyType< ResourceSharedPtrForegroundBrushProperty
 ForegroundBrush property. More...
 
- Static Public Attributes inherited from kanzi::Node
static PropertyType< string > NameProperty
 Name property. More...
 
static PropertyType< string > PathProperty
 Path property. More...
 
static PropertyType< string > LocaleProperty
 Locale property. More...
 
static PropertyType< bool > CreatedFromKZBProperty
 CreatedFromKZB property. More...
 
static PropertyType< bool > HitTestableProperty
 HitTestable property. More...
 
static PropertyType< bool > HitTestableContainerProperty
 HitTestableContainer property. More...
 
static PropertyType< bool > VisibleProperty
 Visible property. More...
 
static PropertyType< bool > EnabledProperty
 Enabled property. More...
 
static PropertyType< bool > FocusableProperty
 The property specifies whether a node can get active focus and can participate in the focus chain navigation. More...
 
static PropertyType< bool > FocusedProperty
 Specifies that the node is the active focus node, which receives keyboard messages. More...
 
static PropertyType< bool > LogicalFocusProperty
 Specifies that the node has logical focus state. More...
 
static PropertyType< ResourceSharedPtrFontProperty
 Font property. More...
 
static PropertyType< float > VisibleAmountInParentProperty
 VisibleAmountInParent property. More...
 
static PropertyType< float > Projection2DTo3DScaleProperty
 Projection2DTo3DScale property. More...
 
static PropertyType< bool > EnableClickProperty
 EnableClick property. More...
 
static PropertyType< bool > EnableMultiClickProperty
 EnableMultiClick property. More...
 
static PropertyType< ResourceSharedPtrStyleProperty
 Style property. More...
 
static PropertyType< ResourceSharedPtrStateManagerProperty
 StateManager property. More...
 
static PropertyType< void * > PrefabTemplateSourceProperty
 PrefabTemplateSource property. More...
 
static PropertyType< float > WidthProperty
 Width property. More...
 
static PropertyType< float > HeightProperty
 Height property. More...
 
static PropertyType< float > DepthProperty
 Depth property. More...
 
static PropertyType< float > ActualWidthProperty
 ActualWidth property. More...
 
static PropertyType< float > ActualHeightProperty
 ActualHeight property. More...
 
static PropertyType< float > ActualDepthProperty
 ActualDepth property. More...
 
static PropertyType< Node::HorizontalAlignmentHorizontalAlignmentProperty
 HorizontalAlignment property. More...
 
static PropertyType< Node::VerticalAlignmentVerticalAlignmentProperty
 VerticalAlignment property. More...
 
static PropertyType< Node::DepthAlignmentDepthAlignmentProperty
 DepthAlignment property. More...
 
static PropertyType< Vector2HorizontalMarginProperty
 Sets the horizontal space between this node and other nodes that are adjacent to this node in a layout. More...
 
static PropertyType< Vector2VerticalMarginProperty
 Sets the vertical space between this node and other nodes that are adjacent to this node in a layout. More...
 
static PropertyType< Vector2DepthMarginProperty
 Sets the space in the depth direction between this node and other nodes that are adjacent to this node in a layout. More...
 
static PropertyType< Node::ContentStretchContentStretchProperty
 ContentStretch property. More...
 
static PropertyType< float > OpacityProperty
 Opacity property. More...
 
static PropertyType< bool > HoverProperty
 Kanzi updates the HoverProperty for a hit testable node to indicate whether the node is the foremost node under the cursor. More...
 
static PropertyType< bool > ClipChildrenProperty
 ClipChildren property. More...
 
static PropertyType< int > SceneGraphAddNodeChangeChildFlagsProperty
 SceneGraphAddNodeChangeChildFlags property. More...
 
static PropertyType< int > SceneGraphAddNodeChangeParentFlagsProperty
 SceneGraphAddNodeChangeParentFlags property. More...
 
static PropertyType< int > SceneGraphRemoveNodeChangeChildFlagsProperty
 SceneGraphRemoveNodeChangeChildFlags property. More...
 
static PropertyType< int > SceneGraphRemoveNodeChangeParentFlagsProperty
 SceneGraphRemoveNodeChangeParentFlags property. More...
 
- Static Public Attributes inherited from kanzi::ListBoxConcept
static MessageType< ItemSelectedMessageArgumentsItemSelectedMessage
 ItemSelected message type. More...
 
static MessageType< ItemVisibleMessageArgumentsItemVisibleMessage
 ItemVisible message type. More...
 
static MessageType< ItemHiddenMessageArgumentsItemHiddenMessage
 ItemHidden message type. More...
 
static MessageType< TargetChangedMessageArgumentsTargetChangedMessage
 TargetChanged message type. More...
 
static MessageType< ScrolledMessageArgumentsScrolledMessage
 Scrolled message type. More...
 
static MessageType< ScrollStartedMessageArgumentsScrollStartedMessage
 Scroll Started message type. More...
 
static MessageType< ScrollFinishedMessageArgumentsScrollFinishedMessage
 Scroll Finished message type. More...
 
static PropertyType< int > KeepAliveItemCountProperty
 KeepAliveItemCount property. More...
 
static PropertyType< ListBoxConcept::SelectionBehaviorSelectionBehaviorProperty
 SelectionBehavior property. More...
 
static PropertyType< string > ItemGeneratorTypeNameProperty
 ItemGeneratorTypeName property. More...
 
static PropertyType< string > ItemContainerGeneratorTypeNameProperty
 ItemContainerGeneratorTypeName property. More...
 
static PropertyType< ResourceSharedPtrItemTemplateProperty
 ItemTemplate property. More...
 
static PropertyType< ResourceSharedPtrItemContainerTemplateProperty
 ItemContainerTemplate property. More...
 
static PropertyType< int > SelectedItemIndexProperty
 SelectedItemIndex property. More...
 
- Static Public Attributes inherited from kanzi::GridListBoxConcept
static PropertyType< GridListBoxConcept::GridDirectionDirectionProperty
 Direction property. More...
 
static PropertyType< float > CellWidthProperty
 CellWidth property. More...
 
static PropertyType< float > CellHeightProperty
 CellHeight property. More...
 
static PropertyType< float > ItemAreaBeginProperty
 ItemAreaBegin property. More...
 
static PropertyType< float > ItemAreaEndProperty
 ItemAreaEnd property. More...
 
static PropertyType< Vector2ScrollAxisProperty
 ScrollAxis property. More...
 
static PropertyType< float > RecognitionThresholdProperty
 RecognitionThreshold property. More...
 
static PropertyType< int > MinimumNumberOfTouchesProperty
 MinimumNumberOfTouches property. More...
 
static PropertyType< int > MaximumNumberOfTouchesProperty
 MaximumNumberOfTouches property. More...
 
static PropertyType< float > SensitivityProperty
 Sensitivity property. More...
 
static PropertyType< float > SlidingAccelerationCoefficientProperty
 SlidingAccelerationCoefficient property. More...
 
static PropertyType< float > SlidingDragCoefficientProperty
 SlidingDragCoefficient property. More...
 
static PropertyType< float > DraggingAccelerationCoefficientProperty
 DraggingAccelerationCoefficient property. More...
 
static PropertyType< float > DraggingDragCoefficientProperty
 DraggingDragCoefficient property. More...
 
static PropertyType< float > DraggingImpulseFactorProperty
 DraggingImpulseFactor property. More...
 
static PropertyType< float > SwipeDistanceProperty
 SwipeDistance property. More...
 
static PropertyType< float > CalculatedOffsetProperty
 CalculatedOffset property. More...
 
static PropertyType< Vector2ScrollPositionProperty
 ScrollPosition property. More...
 
static PropertyType< Vector2ScrollTargetPositionProperty
 ScrollTargetPosition property. More...
 
static PropertyType< Vector2ScrollSpeedProperty
 ScrollSpeed property. More...
 
static PropertyType< bool > ScrollingProperty
 Scrolling property. More...
 
- Protected Types inherited from kanzi::Node2D
enum  Node2DFlags {
  AllowClear, AllowRenderChildren, AllowRenderSelf, ForegroundIsTranslucent,
  ForegroundTranslucencyRequested, RequiresBackgroundQuad, RequiresExtract, ChildrenRequireExtract,
  Node2DFlagsBitCount
}
 Different Node2D flags for bit set. More...
 
- Protected Types inherited from kanzi::Object
typedef vector< AppliedStyleEntrySharedPtrAppliedStyleContainer
 Applied style container. More...
 
- Static Protected Member Functions inherited from kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Protected Member Functions inherited from kanzi::Node
static VisitorResult updateResourceVisitor (Node &node, const ResourceID &id)
 
static VisitorResult updateAllResourcesVisitor (Node &node)
 
static VisitorResult applyStylesVisitor (Node &node, bool apply)
 
static VisitorResult attachVisitor (Node &node)
 
static VisitorResult detachVisitor (Node &node)
 
static VisitorResult validateDrawVisitor (Node &node)
 Visitor for validating draw. More...
 
static bool processPropertyChanged (Node &node, AbstractPropertyType propertyType, const PropertyStoragePtr &nodePropertyStorage, AbstractPropertyTypeDescriptor::PropertyStorage *changedPropertyStorage, PropertyNotificationReason reason)
 Processes notification handlers for node and property storage. More...
 
static VisitorResult propertyChangedVisitor (Node &node, AbstractPropertyType propertyType, AbstractPropertyTypeDescriptor::PropertyStorage *propertyStorage, PropertyNotificationReason reason)
 
- Protected Attributes inherited from kanzi::Node2D
unique_ptr< NodeVisual2Dm_visual
 Visual information. More...
 
unique_ptr< NodeCompositor2Dm_compositor
 Composition and caching information. More...
 
QuadDescription m_backgroundQuadDescription
 Background clipping quad / composition quad description. More...
 
ClippingArea m_clipping
 Clipping parameters. More...
 
CompositionRequirements m_compositionRequirements
 Composition requirements for this 2D node. More...
 
- Protected Attributes inherited from kanzi::Object
AppliedStyleContainer m_appliedStyles
 Listing of applied styles applied to this object. More...
 

Detailed Description

Represents a node that layouts its list of 2D items in a grid.

Each cell in the grid has equal size that must be specified by setting the CellWidthProperty and CellHeightProperty to the list box. The number of rows and columns is specified by setting the size of the list box: the list box displays as many cells as fits to the its boundaries.

Items in the cells that don't fit to the grid area are made invisible. The grid list box can be scrolled with user input to display more items. All items can be temporarily dragged outside the grid area, but when the user is not giving input, the list box scrolls the items back to the edge of the grid.

To handle input, internally the list box uses ScrollView2D that uses the list box area to collect input. To configure the scroll view, the scroll view properties set to the list box are forwarded to the scroll view.

See also
For general documentation about list boxes, see ListBoxConceptImpl.

Examples

To create a Grid List Box 2D:

// Create a Grid List Box 2D named MyListBox.
GridListBox2DSharedPtr gridListBox = GridListBox2D::create(domain, "MyListBox");

To configure the grid area:

// Make each grid cell be a 100x100 square.
gridListBox->setCellWidth(100.0f);
gridListBox->setCellHeight(100.0f);
// Make the grid contain three rows that are filled column by column.
gridListBox->setHeight(300.0f);
gridListBox->setDirection(GridListBoxConcept::GridDirectionDown);
// Make the grid contain 10 columns. Items that are dragged beyond these columns are made invisible.
gridListBox->setWidth(1000.0f);
// Change the resting position when the list is scrolled to the beginning or end, so that items are not right at the grid edge.
gridListBox->setItemAreaBegin(0.2f);
gridListBox->setItemAreaEnd(0.8f);

To add items to the list box:

// Create images and add them as items of the list box.
// Items on the grid appear in the order you add them to the list.
for (int i = 0; i < 5; ++i)
{
Image2DSharedPtr item = Image2D::create(domain, "item" + to_string(i));
item->setImage(item->acquireResource<Texture>(ResourceID("DefaultTexture")));
// Make the images shrink to the cell size.
item->setHorizontalAlignment(Node::HorizontalAlignmentStretch);
item->setVerticalAlignment(Node::VerticalAlignmentStretch);
gridListBox->addItem(item);
}

Constructor & Destructor Documentation

kanzi::GridListBox2D::GridListBox2D ( Domain domain,
string_view  name 
)
explicitprotected

Member Function Documentation

static GridListBox2DSharedPtr kanzi::GridListBox2D::create ( Domain domain,
string_view  name 
)
static

Creates a grid listbox node.

Parameters
domainThe UI domain the new node belongs to.
nameName of the node.
static PropertyTypeEditorInfoSharedPtr kanzi::GridListBox2D::makeEditorInfo ( )
static
GridDirection kanzi::GridListBox2D::getDirection ( ) const
inline

Gets the value of DirectionProperty.

See also
setDirection()
void kanzi::GridListBox2D::setDirection ( GridDirection  value)
inline

Sets the value of DirectionProperty.

See also
getDirection()
float kanzi::GridListBox2D::getCellWidth ( ) const
inline

Gets the value of CellWidthProperty.

See also
setCellWidth()
void kanzi::GridListBox2D::setCellWidth ( float  value)
inline

Sets the value of CellWidthProperty.

See also
getCellWidth()
float kanzi::GridListBox2D::getCellHeight ( ) const
inline

Gets the value of CellHeightProperty.

See also
setCellHeight()
void kanzi::GridListBox2D::setCellHeight ( float  value)
inline

Sets the value of CellHeightProperty.

See also
getCellHeight()
float kanzi::GridListBox2D::getItemAreaBegin ( ) const
inline

Gets the value of ItemAreaBeginProperty.

See also
setItemAreaBegin()
void kanzi::GridListBox2D::setItemAreaBegin ( float  value)
inline

Sets the value of ItemAreaBeginProperty.

See also
getItemAreaBegin()
float kanzi::GridListBox2D::getItemAreaEnd ( ) const
inline

Gets the value of ItemAreaEndProperty.

See also
setItemAreaEnd()
void kanzi::GridListBox2D::setItemAreaEnd ( float  value)
inline

Sets the value of ItemAreaEndProperty.

See also
getItemAreaEnd()
Vector2 kanzi::GridListBox2D::getScrollPosition ( ) const
inline

Gets the value of ScrollPositionProperty.

See also
setScrollPosition()
Vector2 kanzi::GridListBox2D::getScrollTargetPosition ( ) const
inline

Gets the value of ScrollTargetPositionProperty.

See also
setScrollTargetPosition()
Vector2 kanzi::GridListBox2D::getScrollSpeed ( ) const
inline

Gets the value of ScrollSpeedProperty.

See also
setScrollSpeed()
bool kanzi::GridListBox2D::isScrolling ( ) const
inline

Gets the value of ScrollingProperty.

See also
setScrolling()
void kanzi::GridListBox2D::initialize ( )
protected
void kanzi::GridListBox2D::setInitialScrollPosition ( )
protected
virtual void kanzi::GridListBox2D::onAttached ( )
protectedvirtual

The documentation for this class was generated from the following file: